home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
cctrx40.zip
/
CCTRX.DOC
< prev
next >
Wrap
Text File
|
1992-06-30
|
10KB
|
227 lines
The CC-TRX Credit Card Door 4.0
for RemoteAccess
Copyright 1991, 1992 by Randy Blackmond
All Rights Reserved
The CC-TRX Credit Card Door allows you to accept credit card purchases on
your BBS! The transactions can be for products or services such as share-
ware registrations, BBS subscriptions or merchandise! The door is fully
sysop configurable so you may accept any credit card for any item!
Features:
1) Up to 9 credit cards can be configured
2) Unlimited number of transaction items can be configured
3) A sales tax (or other markup) percentage can be configured per item
4) A shipping or other flat rate charge can be configured per item
5) A shipping address prompt can be configured per item
6) Users' security can be upgraded per item
7) Users' flags can be modified per item
8) Users' subscription expiration date can be modified per item
9) A voice phone number prompt can be configured globally
10) Optional Visa and MasterCard number validation using the
Modulus 10 Luhn formula
11) An external program can optionally be run after a transaction
INSTALLATION
------------
The first thing you need to do is make sure the RA environment variable
is set via your AUTOEXEC.BAT or BBS batch file. This is done by assigning
your RA system directory to the RA variable with the following DOS command:
SET RA=<directory>
For example, my RA system directory is G:\RA so my Set line would be as
follows:
SET RA=G:\RA
Next, copy CCTRX.EXE and CCTRXCFG.EXE to either your RA system directory
or create a separate directory for CC-TRX.
Run CCTRXCFG.EXE to create/edit the configuration file for CC-TRX. The
name of the configuration file is CCTRX.CFG.
Add CC-TRX to the menu of your choice with the following Optional Data
line (if CCTRX.EXE resides in your RA system directory):
CCTRX.EXE *M
The *M is optional, but will ensure there is plenty of memory available
for CC-TRX to use so it is recommended.
If you created a separate directory for CC-TRX, you will need to create
a batch file containing the commands to change to the CC-TRX directory
and execute CC-TRX. This method can be used with either a type 7 or type
15 shell.
All transactions made in the CC-TRX Door are written to a text file named
CCTRX.TRX.
There are nine optional, external display files you may create to be used
by CC-TRX. They follow the ASC/ANS naming convention for RA display files,
but must reside in the same directory as CCTRX.EXE. The files are displayed
with More prompting. They are as follows:
CCMENU.A* - The menu files for CC-TRX.
CCWELC.A* - This file is displayed immediately after the opening CC-TRX
title screen.
CCSAVED.A* - This file is displayed after a successful transaction has
been saved.
CCCARD.A* - This file is displayed before the user is prompted to select
which credit card they wish to use.
CCTRANS.A* - This file is displayed after the user selects "Perform Credit
Card Transaction" from the CC-TRX menu.
CCBADCC.A* - This file is displayed when a user enters a Visa or
MasterCard that fails the validation check (when the Refuse
Invalid toggle is enabled).
CCFILE1.A* - This file is displayed if the user presses '1' at the menu.
Automatic More prompting is used.
CCFILE2.A* - This file is displayed if the user presses '2' at the menu.
Automatic More prompting is used.
CCFILE3.A* - This file is displayed if the user presses '3' at the menu.
Automatic More prompting is used.
These files can include some of the control-codes used by RA such as the
clear-screen, pause, user name, etc. Those which are not supported will
be displayed as N/A.
EXTERNAL PROGRAM
----------------
The external program, if enabled, can be and do anything you like.
CC-TRX will pass two parameters to the external program. The first is
the user name in the form FirstName_LastName (note the underscore). The
second parameter is the number of the transaction item they selected.
Of course, if you're not a programmer, this option won't do you much good.
However, if you so desire, I will write a custom program for you to do
what you want for $20.00. The only restrictions are that the program not
be TOO complex and that you have registered CC-TRX. Now, my definition
and your definition of "Too Complex" may not be the same, so shoot your
idea to me and I'll be glad to give it consideration. Also, any custom
program written by me will remain my property and will be copyrighted by
me. The reason I do this is someone may give me an idea that I may want
to incorporate as an added feature in a future version of CC-TRX.
NOTE
----
As stated above, CC-TRX uses the Modulus 10 Luhn Formula for validating
Visa and MasterCard numbers. I and others have discovered that many
Visa cards use a different method of check-digit calculation and will
therefore fail a verification check. The options to overcome this until
I can discover the new check-digit formula are as follows:
1) Do not enable validation check for Visa cards.
2) Enable validation checks for Visa, but disable the 'Refuse Invalid
Visa/MC' toggle.
3) Enable the validation and refusal options and use the CCBADCC.A* display
file to instruct the user to leave you the order/card information in
a message for manual processing.
SUPPORT/SUGGESTIONS
-------------------
As with all of my shareware products, I strongly urge users to offer sug-
gestions for further enhancement of my software. Without suggestions, a
program will whither and die. WITH suggestions, a program can grow and
become an even more useful tool!
If you have any problems setting up CC-TRX, have a bug to report or want
to offer a suggestion for future versions, you can contact me in several
ways: Via FIDO NetMail at 1:381/70, Via FIDO EchoMail in the RA_UTILS
echo, call my BBS at 505-589-0319 USR DS and leave a message or call my
voice line at 505-589-0317 24 hours (answering machine on duty).
Be sure to check out RAMail, THE QWK Compatible MailDoor for RA, and
Txt2Msg for RA!
HISTORY
-------
1.0 Initial Release of CC-TRX!
2.0 Added User Flag Setting and External Program support. Fixed bug
that limited transaction selection to 9 instead of 75.
2.1 Fixed Bug that caused Flags to be set exactly as shown in the CFG
file. It was supposed to only turn on flags set in the CFG, not
turn off flags not set! Works properly now. Due to the unreliability
of the Luhn validation method, the user is merely warned when a
card number is flagged as invalid, but is allowed to continue the
transaction.
2.2 Fixed bug that occurred when more than 9 transaction items were
configured. The card number validation routine for Visa and
Mastercard (the Luhn Formula) has been fixed.
3.0 Included a configuration program to ease CC-TRX configuration.
Added Subscription Expiration Date modification. The number of
transaction items you may configure is now unlimited.
3.1 Just a couple of bug fixes for this version. Pause was added to
each screenful display of TRX items. TRX count was erroneously
being used to determine the number of valid responses to the
credit card number selection, i.e. if you had only 2 TRX items
configured, a user could not select a credit card numbered above
2!
4.0 Added ability for user to select multiple items without having to
enter credit card info for each item. Added a quantity prompt for
each item. User can add or delete items after completing selections.
A message is written to the user after a successful transaction
showing all information about his transaction. This message is
placed on Board 1 as a private message.
DISCLAIMER
----------
I make no guarantees to the suitability or functionality of CC-TRX on your
system nor will I be held liable for any damages caused to you or your
system directly or indirectly by CC-TRX. I will, however, assist you to
the best of my ability to get CC-TRX running for you should you need
assistance. USE AT YOUR OWN RISK!
REGISTRATION
------------
CC-TRX is a shareware product, which means you try before you buy. If you
use CC-TRX beyond a 2 week evaluation period, you are required to register
it with the author. Complete and mail the following registration form with
a check or money order.
Randy Blackmond CC-TRX Credit Card Door v4.0
RR #1 Box 634 Registration Form
Anthony, NM 88021
CC-TRX 4.0 is $20.00 US/$25.00 INTERNATIONAL
YOUR NAME _____________________________ YOUR VOICE PHONE _________________
YOUR BBS NAME ___________________________ YOUR BBS PHONE _________________
BAUD RATES SUPPORTED ___________________
ARE YOU IN FIDO? IF SO, YOUR NODE ADDRESS ________________
ARE YOU IN RIME? IF SO, YOUR NODE ID ________________
COMMENTS/SUGGESTIONS _____________________________________________________
__________________________________________________________________________
__________________________________________________________________________